home *** CD-ROM | disk | FTP | other *** search
/ GIFs Galore 1993 September / Walnut Creek GIFs Galore CDROM WIN-MAC (Walnut Creek CDROM)(September 1993).iso / pc / macutils / misc / tar / tar_manu.al < prev   
Text File  |  1991-08-06  |  8KB  |  77 lines

  1. Tar for the Macintosh
  2. Version 3.0
  3.  
  4. What's New
  5.  
  6. The third version of tar for the Macintosh is now System 7.0 compatible.  Tar can read and write floppy disks directly, allowing exchange with other systems (like Unix).  However, the tar archive must fit on a single floppy, as multiple volumes are not supported yet.  Another newline conversion option has been added to allow you to extract files with MS-DOS format end of line conventions.  Tar will now create a preference file to remember any preferences you select.  Also, several bugs have also been fixed.
  7.  
  8. Description
  9.  
  10. This program reads and writes tar format archives.  It has been tested against tar running on A/UX (2.0.1), 4.3 BSD and the GNU tar program (POSIX compatible).  Floppies have been exchanged with A/UX on a IIsi and a Sun Sparc IPC.  The tar archive manipulation code is based on John Gilmore's public domain tar program.  Tar is public domain.  The source code is available in a separate StuffIt archive.  The source code was compiled with the MPW 3.2 C compiler.  The resources (tar.r) are in MPW rez format.  It has been tested under 6.0.7, 7.0 and A/UX on a IIsi.  Note: tar will only archive the data forks of Macintosh files.
  11.  
  12. The File Menu
  13.  
  14. Create
  15. This selection allows you to create a tar archive (with variations with selections from the Preferences menu).  The first dialog box will either ask you for the name of the tar archive (Standard File) or will ask you to insert a floppy (either insert a floppy or press the Cancel button).  Warning: the floppy must be formatted before using with tar!  Also, using a floppy as the destination of a create will cause the contents to be destroyed!  The second dialog box allows you to select the directory (or directories) to be placed into the archive.  This is like the Standard File dialog, except that there is another button, "Select".  Pressing the select button will place the entire directory shown at the top of the file list into the archive.  Pressing the "Open" button when a file in the file list is highlighted is the same as pressing "Select".  Pressing "Open" when a directory in the file list is highlighted causes that directory to become the possible selection candidate.  The "Cancel" button is used to terminate the archive creation.  After each directory is added to the archive, this dialog will appear again to give you the chance to add other directories to the archive.  The other buttons behave like their counterparts.  You may stop the create by typing "Command-.".
  16.  
  17. Extract
  18. This selection allows you to extract a tar archive (from either a file or a floppy).  The first dialog box will either ask you for the name of the tar archive (Standard File) or will ask you to insert a floppy.  The second is the directory selection dialog, and is used to tell tar where to place the extracted files (like in Create).  You may stop the extraction by typing "Command-.".
  19.  
  20. List
  21. This selection allows you to list the contents of a tar archive to either the screen or printer.  The only dialog is the tar archive selection (Standard File).  You may stop the listing by typing "Command-.".
  22.  
  23. Page Setup
  24. This selection allows you to select the page options for printing.
  25.  
  26. Save Preferences
  27. This selection will create a preference file (in the System Folder or Preferences folder, if possible) that will cause tar to use the current preferences selected to be used next time tar is launched.
  28.  
  29. Quit
  30. Exits tar.
  31.  
  32. The Edit Menu
  33.  
  34. The Edit menu is only used to support desk accessories.
  35.  
  36. The Preferences Menu
  37.  
  38. Any option listed in the Preferences menu will be remembered the next time tar is launched if you select "Save Preferences" in the File menu.
  39.  
  40. Convert Newlines
  41. When checked, carriage returns ('\r' or 0x0D) are translated to line feeds ('\n' or 0x0A) during archive creation.  During extraction, line feeds are translated to carriage returns.  Note this occurs in the body of all files, and is thus useful only for source or text transfers.  When not checked, no conversion takes place.  This is mutually exclusive with the "Strip LFs" option.
  42.  
  43. Strip LFs (Ext Only)
  44. When checked, causes stripping of line feeds that immediately follow carriage returns.  In effect, it converts MS-DOS style line endings to Macintosh style line endings.  When not checked, no conversion takes place.  This is mutually exclusive with the "Convert Newlines" option.
  45.  
  46. Old Tar Compatible
  47. When checked, tar will create archives with the old format.  Otherwise the new standard format is used.  Tar will read archives of either type, regardless of the state of this option.
  48.  
  49. Use Floppy
  50. When checked, tar will use a floppy disk as the archive file source or destination.  See the warning in the description of Create, above.  This option allows the exchange of tar archives on floppies.  Note that this is done by treating the floppy as "a single file". On Unix systems, the device file to tell tar to use will be something like "/dev/rfloppy0" or "/dev/rfd0".  Note that you must use a preformatted disk, as tar will not format it for you.  Most likely, you will have to format it as either a 1.44 MB or 720 KB floppy to be readable in a non-Macintosh drive.
  51.  
  52. Block Size
  53. This option brings up a dialog box that allows you to set the blocking size.  This is arbitrarily limited to between 1 and 128 512-byte blocks (inclusive).  For tar archives on disk, this only affects the efficiency of the disk transfer.  For floppy archives, the block size should be an integral divisor of the number of sectors on the floppy (for that particular format).
  54.  
  55. Page Screen Listings
  56. When checked, causes the listing of the archive file contents to stop at each screen full.  When the message "Press any key to continue" appears, any key press will cause the listing to continue.  Note that the "List" archive selection will always be paged in this fashion.
  57.  
  58. List to Printer
  59. When checked, causes the listing of the archive file contents to be printed to the current printer.  A print job dialog will be shown after the archive file and directory selection dialogs.  Note that this will work for all three file options.
  60.  
  61. Set Creator/Type
  62. This option brings up a dialog box that allows you to set the Finder Creator and Type for all extracted files.
  63.  
  64. The File List Window
  65.  
  66. In each case (create, extract, list), if the "List to Printer" option is not selected, a file list window will display the files (in Unix pathname format) being inserted, extracted or listed.  You may stop the scrolling of this window by typing "Command-S".  "Command-Q" will restart the display.
  67.  
  68. Limitations
  69.  
  70. Tar only works under 6.0.5 or later, and only on HFS (or compatible) file systems.  Tar does not understand the device, link, FIFO and contiguous file types defined for the tar header.  Tar does not allow selective extractions, and will not allow a single file to be placed in the archive (unless it is the only file in a directory).  Tar does not include the resource fork.  The tar archive format does not allow names longer than 100 characters.  For creation, the 100 character limit is relative to the directory being archived, and does not include any part of the pathname for directories leading to it.  For extraction, the longest name that will be created is 100 characters, and again, this is relative to the extraction directory.  Macintosh file attributes (except for modification date and data fork size) are not kept.
  71.  
  72. In Conclusion
  73.  
  74. I welcome your comments, suggestions and gripes.  You may send e-mail to "cruff@ncar.ucar.edu". 
  75.  
  76. The icons are courtesy a kind person in Finland, whose name I've lost. :-(
  77.